home *** CD-ROM | disk | FTP | other *** search
/ Group 42-Sells Out! - The Information Archive / Group 42 Sells Out (Group 42) (1996).iso / commun / scanner / pager / pd.txt < prev    next >
Text File  |  1996-01-28  |  9KB  |  308 lines
  1.  
  2.                           PD  -  POCSAG Decoder
  3.  
  4.                            User Documentation
  5.  
  6.                         Version 1.02   June 1995
  7.  
  8.  
  9.  
  10.                               Contents
  11.  
  12.  
  13.     1.        Introduction
  14.     
  15.     2.        Registration
  16.     
  17.     3.        Installation
  18.     
  19.     4.        Interfacing
  20.     
  21.     5.        Configuration
  22.     5.1        PD.INI
  23.     5.1.1        General Parameters
  24.     5.1.2        Function Codes
  25.     5.2        PAGERS.INI
  26.     5.3        REJECT.INI
  27.     
  28.     6.        Running the program
  29.     6.1        Command Line Options
  30.     6.2        Supported Keys
  31.     6.3        Status Line
  32.     6.4        Normal Mode
  33.     6.5        Debug Mode
  34.     
  35.  
  36. 1.    Introduction
  37.  
  38. PD, together with a receiver or scanner, allows the off-air decoding of
  39. POCSAG paging signals at either 1200 or 512 bits/second. This makes it
  40. extremely useful for the testing of paging transmitters and systems.
  41.  
  42. Decoding of both numeric and alphanumeric pager data is supported, as is
  43. the hex dumping of raw POCSAG codewords.
  44.  
  45. PD runs on an IBM PC or equivalent, anything from an 8086 upwards. It 
  46. requires 512K of conventional memory and a small amount of hard disk
  47. or floppy. Hard disk is recommended.
  48.  
  49. PD runs from DOS, running from Windows is not recommended.
  50.  
  51.  
  52. 2.    Registration
  53.  
  54. PD is freely distributed as a shareware version. This has a timeout of
  55. about 5 minutes, after which a registration message is displayed and
  56. the program exits. Also the logging of pager data to disk is disabled.
  57.  
  58. To obtain a fully functional registered copy of PD send a cheque or money
  59. order for 20.00 pounds sterling to:-
  60.  
  61.             Peter Baston,
  62.             7 Allerton Close,
  63.             Pen-y-ffordd,
  64.             Clwyd,
  65.             CH4 0NJ,
  66.             U.K.
  67.  
  68.  
  69. 3.    Installation
  70.  
  71. In order to install the program copy the following files into a directory
  72. on a hard drive, or onto a floppy:-
  73.  
  74.     PD.EXE        Pocsag Decoder program
  75.     PD.INI        Configuration file
  76.     PAGERS.INI    List of pager codes (7 digit RIC's) to be logged
  77.     REJECT.INI    List of pager codes to reject
  78.     PD.TXT        This documentation file
  79.  
  80.  
  81. 4.    Interfacing 
  82.  
  83.  
  84. The PD program requires serial POCSAG data to be applied to the CTS pin
  85. of one of the PC's COM ports. RS232 levels are required, ie at least +/-
  86. 3v. PD is insensitive to polarity, ie it doesn't matter which way up mark 
  87. and space are.
  88.  
  89.  
  90. As POCSAG is transmitted as direct FSK of the VHF/UHF carrier the ideal
  91. way is to take the data direct from the discriminator, via a data slicer.
  92. The following circuit, however, has been fairly successful, taking audio
  93. directly from the receiver's speaker output:-
  94.  
  95.  
  96.   0.1 uF                    |\ +12v
  97. ---||-----------------------|- \|
  98. AF IN    |                  |741 \
  99. ----     |                  |    /--------------------- Data Out
  100.     |    \            ------|+ /|  |                    CTS (pin 5/8)
  101.     |    / 100K       |     |/-12v |
  102.     |    \            |            |         GND ------ GND (pin 7/5)
  103.    GND   /            ----/\/\/\---- 
  104.          |            |    100K
  105.          |            \                  N.B. Pin Numbers for com port are
  106.         GND           /                  given as x/y, where x is for a 25
  107.                       \  10K             way, y for a 9 way.
  108.                       /
  109.                       |
  110.                      GND      
  111.  
  112. The +/- 12v for the op-amp can be derived from unused signals on the COM
  113. port (gives more like +/- 10v but works fine !):-
  114.  
  115.  
  116.     TxD (2/3) --------------|<-------------------------------------- -12v
  117.                                      |                  |
  118.     RTS (4/7) --------------|<--------       GND        - -
  119.                    |                          |         _ +  1uF
  120.                     --------->|-------        - -       |
  121.                     Diodes 1N4148    |        - + 1uF  GND
  122.                                      |        |
  123.     DTR (20/4) ------------->|-------------------------------------- +12v
  124.  
  125.  
  126.  
  127. 5.    Configuration
  128.  
  129. 5.1    PD.INI
  130.  
  131. The PD.INI file allows a limited amount of configuration of the PD program.
  132. Any text editor can be used to edit this file. The file is divided up into
  133. sections, headed by a name in square brackets, eg [general], [functions].
  134. In each section are parameters, set to a value with an "=" sign, eg:-
  135.  
  136. logbeep=100
  137. func1=alpha
  138.  
  139.  
  140.  
  141. 5.1.1    General Parameters
  142.  
  143. These parameters come under the [general] heading. This version only supports
  144. one parameter in this section
  145.  
  146. 5.1.1.1    logbeep
  147.  
  148. This parameter allows the length of the "beep", sounded when a pager message
  149. is logged, to be set. It's format is:-
  150.  
  151. logbeep=<number>
  152.  
  153. eg:-
  154.  
  155. logbeep=100
  156.  
  157. Where <number> is the length of the beep in milliseconds. A value of zero
  158. turns off the beeping, this is the default.
  159.  
  160. 5.1.2    Function Codes
  161.  
  162. These parameters come under the [functions] heading. Four parameters are
  163. supported - func0, func1, func2 and func3. These allow the decoding of
  164. the pager data to be determined by the function code, transmitted in the
  165. address codeword. The format for setting these parameters is:-
  166.  
  167. funcx=<string>
  168.  
  169. Where <string> is one of:- 
  170.  
  171. alpha        -    The message will be decoded as alphanumeric ASCII 
  172.             data.
  173.  
  174. numeric        -    The message will be decoded as BCD numeric data.
  175.  
  176. raw        -    The message will be dumped in raw form, as hex
  177.             codewords
  178.  
  179. eg:-
  180.  
  181. func0=raw
  182. func1=numeric
  183. func2=numeric
  184. func3=alpha
  185.  
  186. The program defaults to decoding all function codes as "alpha" data.
  187.  
  188.  
  189. 5.2    PAGERS.INI
  190.  
  191. This file contains a list of pager addresses to be logged and is simply
  192. a list of 7 digit RIC's, eg:-
  193.  
  194. 1234567
  195. 0012345
  196. etc
  197.  
  198. This file may contain up to 100 addresses. Every time one of these
  199. addresses is encountered it is highlighted on the screen, a beep is
  200. sounded if configured, and the page is logged to disk with a date/time
  201. stamp. The log filename is <RIC>.TXT, eg 1234567.TXT.
  202.  
  203.  
  204. 5.3    REJECT.INI
  205.  
  206. This file contains a list of pager addresses to be rejected, eg to save
  207. screen clutter. This file has the same format as described in 5.3 above.
  208.  
  209.  
  210. 6.    Running the Program
  211.  
  212.  
  213. 6.1    Command Line Options
  214.  
  215. PD is run from the DOS prompt with the following format:-
  216.  
  217. PD <-Px> <-B512>
  218.  
  219. Where the command line options are:-
  220.  
  221. -Px    Use COM port x. Default is COM1.
  222.  
  223. -B512    Forces 512 bits/second POCSAG decoding, default is 1200 bps.
  224.  
  225.  
  226. 6.2    Supported Keys
  227.  
  228. The following keys are supported whilst PD is running:-
  229.  
  230. ESC        Exits the program
  231.  
  232. F1        Toggles between NORMAL and DEBUG modes
  233.  
  234. SPACE BAR    Toggles PAUSE mode on and off
  235.  
  236.  
  237. 6.3    Status Line
  238.  
  239. After PD starts up it displays a status line across the top of the screen,
  240. with a data area below. The status line is as shown below:-
  241.  
  242.  
  243. NORMAL COM1 1200           * PD Version 1.02 *           PAUSE REJ / 09:30:57
  244.  
  245.  
  246. The items on the status line are described below, from left to right:-
  247.  
  248. *  NORMAL/DEBUG indicator - shows which mode PD is currently operating in.
  249.  
  250. *  COM port currently in use.
  251.  
  252. *  Current POCSAG bit rate.
  253.  
  254. *  Version of PD being used.
  255.  
  256. *  PAUSE indicator - appears when paused by the space bar.    
  257.  
  258. *  REJ indicator - appears when a pager address matches one listed in
  259.    REJECT.INI
  260.  
  261. *  Rotating signal indicator. Appears to rotate when data is being
  262.    received on the correct pin of the COM port. This is no indication of
  263.    good data, just that the levels are correct.
  264.  
  265. *  The current time from the PC's real time clock.
  266.  
  267.  
  268. 6.4    Normal Mode
  269.  
  270. In NORMAL mode, as long as good POCSAG data is being received, lines of
  271. the following form are displayed:-
  272.  
  273. [RIC] [Function Code] <data>
  274.  
  275. eg:-
  276.  
  277. 1234567 3 Please call 1234 - 5688
  278. 0345678 1 Test call
  279.  
  280. [RIC] is the 7-digit RIC pager address
  281. [Function Code] is the transmitted function code 0,1,2 or 3
  282. <data> is numeric,alphanumeric or hex depending on the function code.
  283.  
  284. The data field may overflow onto multiple lines.
  285.  
  286. Before data is displayed in NORMAL mode the address codeword is checked
  287. for errors and must be error-free. Subsequent data codewords are not
  288. checked for errors. Some "garbling" of data may therefore occur if a
  289. good signal is not being received, although received RIC codes are
  290. guaranteed to be good.
  291.  
  292.  
  293. 6.5    Debug Mode.
  294.  
  295. In Debug mode the raw POCSAG codewords are dumped to the screen in hex
  296. form, eg:-
  297.  
  298. 7A89C197 7A89CI97 7A89C197 7A89C197 7A89C197 7A89C197 7A89C197 7A89C197
  299. 7A89C197 7A89C197 14083EE2 7A89C197 7A89C197 7A89C197 7A89C197 7A89C197
  300.  
  301. Any codewords which do not pass the BCH and parity error checking are
  302. highlighted. This is very useful for checking the quality of the
  303. received signal.
  304.  
  305.  
  306.                            <<<<=====>>>>>
  307.  
  308.